| GLUTMAINLOOPEVENT(3) | Library Functions Manual (local) | GLUTMAINLOOPEVENT(3) |
NAME¶
glutMainLoopEvent —
Dispatches all pending events.
LIBRARY¶
OpenGLUT - mainloop
SYNOPSIS¶
#include
<openglut.h>
void
glutMainLoopEvent(void);
DESCRIPTION¶
The general outline of this function is to first drain the queue of windowsystem events, in most cases dispatching each as it is found. After the queue is empty, we check for timer-based events, coalesced window events (e.g., redisplays), and windows that need to be closed.
The cross-reference section for this function's documentation should ideally contain every callback, but the list would be tediously long and prone to omissions.
CAVEATS¶
Does not necessarily dispatch events that are received
after
this function starts processing.
At first glance, this function may not seem to afford any new capability that you couldn't get with an idle callback or glutLeaveMainLoop(). However there are other GLUT-like libraries that may have their own window event processing loops. Having glutMainLoopEvent() allows you to ask OpenGLUT to do its work in a batch, then return to whatever processing the other library (or libraries) require.